home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / EDITORS / WPHELP.ZIP;1 / TEXTCON.EXE / TEXTCON.DOC next >
Encoding:
Text File  |  1986-12-09  |  62.0 KB  |  1,387 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                           
  8.                                TEXTCON (Version 1.3)
  9.                       A Program for Conversion of ASCII Files
  10.                               Between Word Processors
  11.                                           
  12.                                      Chris Wolf
  13.                                           
  14.                                  November 30, 1986
  15.                                           
  16.             
  17.             PURPOSE:
  18.             
  19.             
  20.             Virtually all word processors will import ASCII files, but
  21.             anyone who has tried it knows that the results are often
  22.             less than optimal.  Documents that are transferred this way
  23.             almost always require a great deal of manual "cleaning up"
  24.             to get them into the desired format.
  25.             
  26.             TEXTCON is a file "pre-processor" for MSDOS computers that
  27.             does much of the necessary conversion automatically.  The
  28.             ASCII files that it produces are in a form more suitable for
  29.             importation to most word processors.  TEXTCON will not
  30.             eliminate all manual editing, but it makes the job much
  31.             easier.
  32.             
  33.             TEXTCON has tremendous power and flexibility that can be
  34.             useful for tasks involving data base files, desktop
  35.             publishing, and program editing.  TEXTCON users have found
  36.             the program helpful for many kinds of file manipulations,
  37.             such as adding line feeds where only carriage returns are
  38.             present, expanding tabs to spaces, removing all blank lines
  39.             from a file, etc.
  40.             
  41.                  (. . . caution . . . advertisement follows . . .)
  42.                                           
  43.             And now, those who contribute $25 or more for TEXTCON will
  44.             be sent TEXTDCA, which has all the features of TEXTCON, but
  45.             will also write files in IBM DCA/RFT format.  This allows
  46.             ASCII or WordStar files to be imported to your word
  47.             processor with spacing characteristics such as margins,
  48.             indents, centering, tab stops, etc. intact.
  49.             
  50.             If you use a word processor that accepts DCA/RFT format
  51.             files (this includes Word Perfect, Microsoft Word, IBM
  52.             Displaywrite, MultiMate, Volkswriter 3, WordStar 2000, and
  53.             many others), TEXTDCA is simply the best program available
  54.             for importing ASCII files.
  55.             
  56.             This can save you a great deal of time that would otherwise
  57.             be spent reformatting the imported file.  An additional
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.             TEXTCON File Converter
  71.  
  72.  
  73.             feature of TEXTDCA is a menu-driven mode (on PC-compatibles
  74.             only) which simplifies the selection of processing options.
  75.             
  76.                          (. . . end of advertisement . . .)
  77.             
  78.             It's convenient to divide the functions performed by TEXTCON
  79.             into five main categories:
  80.             
  81.             1.  Removing carriage returns
  82.             
  83.                 The most common problem when importing ASCII files into
  84.                 word processors is that each line from the original file
  85.                 will end in a "hard" carriage return.  In most cases
  86.                 these have to be removed manually in order to get the
  87.                 document formatted properly on the new word processor.
  88.                 TEXTCON uses a sophisticated algorithm to determine
  89.                 which sections of text constitute "paragraphs", and then
  90.                 it removes all carriage returns except those at the ends
  91.                 of paragraphs.  (For this purpose, a paragraph is
  92.                 defined as a block of text where it is desirable for
  93.                 words to wrap to following or previous lines when edit-
  94.                 ing or formatting changes are made.)
  95.                 
  96.                 TEXTCON can cope with almost any paragraph format
  97.                 including difficult ones like fully indented (nested),
  98.                 hanging indent, outline style, etc.  It does not depend
  99.                 on double spacing or first-line indentation, although
  100.                 these are recognized.  It will handle print-formatted
  101.                 files (i.e., those having a left margin of blanks), as
  102.                 well as the totally unformatted files used as input to
  103.                 formatters like NROFF (as long as they use "dot"
  104.                 commands).  It is designed to recognize header lines,
  105.                 tables, etc. and will avoid reformatting them.
  106.                 
  107.                 (Of course, document formats vary widely, and it really
  108.                 takes human intelligence to recognize paragraph breaks
  109.                 with 100% accuracy.  TEXTCON will occasionally make
  110.                 mistakes when dealing with particularly tricky formats.)
  111.                 
  112.             2.  Adding carriage returns
  113.                 
  114.                 TEXTCON will also do the opposite process if you wish,
  115.                 adding carriage returns to files that have them only at
  116.                 the ends of paragraphs.  Or it can deal with special
  117.                 file formats by substituting carriage returns for some
  118.                 other special character that is used to represent a
  119.                 paragraph end.
  120.                 
  121.             3.  Removing blanks
  122.             
  123.                 An ASCII file may have extraneous blanks that cause
  124.                 problems if they are imported to a word processor.
  125.                 There may be blanks at the beginnings of lines for a
  126.                 left margin or for indented or nested text.  There may
  127.  
  128.  
  129.  
  130.                                           2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.             TEXTCON File Converter
  137.  
  138.  
  139.                 be extra blanks within lines for justified text or
  140.                 between columns of a table (where tabs are more
  141.                 desirable).  TEXTCON removes extraneous blanks and,
  142.                 where appropriate, replaces them with tabs, thus saving
  143.                 manual editing time.
  144.                 
  145.             4.  Removing extraneous lines
  146.             
  147.                 Some ASCII files have extraneous lines that TEXTCON will
  148.                 remove for you.  Print-formatted files, for example,
  149.                 sometimes have additional lines inserted solely for
  150.                 underlining or boldface.  TEXTCON will remove these so
  151.                 you don't have to.  TEXTCON recognizes double-spaced
  152.                 files and converts them to single spacing.  Lines that
  153.                 consist solely of "dot" commands (like WordStar's .PA)
  154.                 are converted to blank lines.  You can also remove (or
  155.                 add) lines by setting the spacing between paragraphs to
  156.                 any specific number of blank lines you wish.
  157.                 
  158.                 Consecutive runs of more than two blank lines are
  159.                 reduced to two, which may help with files that have been
  160.                 formatted for a printer.  TEXTCON also tries to
  161.                 recognize page breaks and eliminate all blank lines
  162.                 between pages if possible.  The situation is more
  163.                 complicated if the file contains headers or footers, but
  164.                 there is now an option which can, in certain cases,
  165.                 remove these as well.
  166.                 
  167.             5.  Removing or converting characters
  168.             
  169.                 TEXTCON translates all characters in WordStar files to
  170.                 their ASCII equivalents.  It also removes all non-
  171.                 printing ASCII characters (except tabs) unless you ask
  172.                 that they be kept.  It has three optional methods for
  173.                 dealing with line-ending hyphens.  TEXTCON does not
  174.                 alter or remove the IBM extended ASCII characters, used
  175.                 for math symbols, letters from foreign alphabets, etc.
  176.             
  177.             TEXTCON was designed to be as automatic as possible in its
  178.             operation so it can be used by someone with very little
  179.             knowledge about the files being converted.  Although it has
  180.             many options for specialized kinds of conversions, it will
  181.             work very well on a wide variety of files without the use of
  182.             any of the options.
  183.             
  184.             The options are described in a later section.  If TEXTCON
  185.             doesn't seem to work quite as you want it to, you may want
  186.             to read those descriptions.  They include more detailed
  187.             information about the kinds of changes TEXTCON makes to a
  188.             file and how you can control these changes.
  189.             
  190.             TEXTCON is useful for importing text to many microcomputer
  191.             word processors, including Microsoft Word, Word Perfect, and
  192.             WordStar, as well as some office automation systems, such as
  193.  
  194.  
  195.  
  196.                                           3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.             TEXTCON File Converter
  203.  
  204.  
  205.             NBI.  If a word processor exhibits problems with "hard
  206.             carriage returns" when you import ASCII files, then the
  207.             chances are that TEXTCON will help.
  208.             
  209.             Some PC word processors, including Volkswriter, MultiMate,
  210.             and PC-Write, actually require the hard returns, and have
  211.             trouble with files that do not include them.  TEXTCON can
  212.             add carriage returns to files so that these word processors
  213.             can import them successfully.
  214.             
  215.             If you are working with a word processor that will accept
  216.             DCA/RFT format files, the TEXTDCA version of TEXTCON offers
  217.             an even higher level of performance than TEXTCON itself.
  218.             
  219.             I am making TEXTCON available for distribution without
  220.             charge, but I hope that anyone who uses it on a regular
  221.             basis will make a monetary contribution toward the time I
  222.             put into developing and supporting it.
  223.             
  224.             
  225.             
  226.             USE:
  227.             
  228.             
  229.             To run the program, use the command form:
  230.                 TEXTCON [options] infile outfile
  231.             where the available options are described in the following
  232.             section.  (Again, TEXTCON will handle most conversions very
  233.             well with no options specified, so most users can ignore all
  234.             mention of options here.)  The file names can include the
  235.             disk-drive identifier and a path name, if appropriate.  A
  236.             typical command with no options would be as follows:
  237.                 TEXTCON A:PROPOSAL B:PROPOSAL.TXT
  238.             The options are identified by a preceding hyphen as a flag
  239.             character, so a command with options might look as follows:
  240.                 TEXTCON -T5 -B TEXT.DOC B:TEXT.ASC
  241.             
  242.             Multiple options can be combined, using a single hyphen, to
  243.             appear as follows:
  244.                 TEXTCON -T5B TEXT C:\DOCS\TEXT.OUT
  245.             You must be careful when combining options this way,
  246.             especially if you are using options with numeric "names" or
  247.             those with sub-options.  For example, if you wanted to use
  248.             the options -T3 -2 -KC -B, and you combined them as -T32KCB,
  249.             this would be interpreted as -T32 -KCB, which is very
  250.             different than you intended.  If, instead, you combined them
  251.             as -2BT3KC, they would be interpreted correctly.  If there
  252.             is any question in your mind about this, keep all of the
  253.             options separate on the command line.  (The menu system in
  254.             TEXTDCA simplifies this quite a bit.)
  255.             
  256.             If you specify an illegal option, such as -Q, the program
  257.             will display the legal options.
  258.             
  259.  
  260.  
  261.  
  262.                                           4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.             TEXTCON File Converter
  269.  
  270.  
  271.             The file specified as "infile" must be an ASCII file or a
  272.             WordStar file; TEXTCON will not work on an internal word
  273.             processor file.  Some word processors, including PC-Write
  274.             and Volkswriter always keep their text in ASCII files.  For
  275.             other word processors, such as MultiMate, Word Perfect, or
  276.             Microsoft Word, you will have to create an ASCII copy of
  277.             your file before TEXTCON will work with it.  If you try to
  278.             convert an internal file, you may not get an error message
  279.             from TEXTCON, but when you load the converted file into
  280.             another word processor, it will probably contain gibberish.
  281.             
  282.             
  283.             
  284.             OPTIONS:
  285.             
  286.             
  287.             Before converting a file, TEXTCON analyzes the initial
  288.             portion to determine certain overall characteristics of the
  289.             document.  During the conversion, the program applies a
  290.             complex set of rules on a line-by-line and character-by-
  291.             character basis to determine localized formatting
  292.             information.  Because of this, the optional parameters
  293.             described here are not usually needed.  In any case, you
  294.             should certainly try a few conversions before using any of
  295.             these options.  Unless you notice problems or are simply
  296.             curious about the options, you can ignore the following
  297.             section.
  298.             
  299.             IMPORTANT:  The letters used to select options have changed
  300.             substantially in Version 1.3.  If you have used options in
  301.             earlier versions, be sure to check the new descriptions
  302.             below carefully, or at least read the "HISTORY" section at
  303.             the end of this document for a summary of the changes.  If
  304.             you use the old option commands, you may get very strange
  305.             results because of their new meanings.
  306.             
  307.             The following describes each of the conversion options
  308.             available in the program.  Note that some of them are inter-
  309.             related or similar in function.  As a conceptual aid, they
  310.             are organized into two groups.  Those in the first group are
  311.             descriptive of the input file format.  If you can provide
  312.             this additional information to TEXTCON, it can do a better
  313.             job of conversion.  The options in the second group describe
  314.             certain types of processing that you want TEXTCON to
  315.             perform.  These options have a direct effect on the format
  316.             of the output file.
  317.             
  318.             The options are shown in upper case, but lower case is
  319.             acceptable as well.
  320.             
  321.             
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                                           5
  329.  
  330.  
  331.  
  332.  
  333.  
  334.             TEXTCON File Converter
  335.  
  336.  
  337.                 INPUT FORMAT DESCRIPTORS
  338.             
  339.             1.  -1, -2
  340.             
  341.                 TEXTCON is designed to recognize the line spacing
  342.                 (single or double) used in a file, but in some rare
  343.                 cases it will make a mistake.  This will often happen
  344.                 when the initial part of the document (the part that
  345.                 TEXTCON analyzes before starting the conversion) has
  346.                 different spacing than the rest.  When TEXTCON finishes
  347.                 its analysis of a file, it displays on the screen what
  348.                 it determined the spacing to be.  If this is wrong, you
  349.                 will have to use the -1 or -2 option to specify that the
  350.                 input file is single- or double-spaced.
  351.                 
  352.                 You can also detect an improper spacing decision from
  353.                 problems in the output file.  The usual symptom is that
  354.                 the converted file either will contain many hard car-
  355.                 riage returns and be double-spaced, or will have many
  356.                 paragraphs run together.
  357.                 
  358.                 If TEXTCON's double-space option is in effect, either
  359.                 through its own decision or because you specified it,
  360.                 single occurrences of blank lines are totally ignored,
  361.                 as if they simply were not in the file.  Two consecutive
  362.                 blank lines are treated as if there were only a single
  363.                 blank line.  Occasionally you may find that this causes
  364.                 some paragraphs to run together in the converted file.
  365.                 This would be most likely to happen if single and double
  366.                 spacing are mixed in the same document, although
  367.                 normally TEXTCON will handle this correctly.
  368.             
  369.             
  370.             2.  -B
  371.             
  372.                 This option tells TEXTCON that your file has only block-
  373.                 style paragraphs, i.e., there are no paragraphs with
  374.                 first-line indents or outdents.  TEXTCON doesn't need to
  375.                 know this in order to process a file, but there are some
  376.                 cases where it can do a better job if it does.  This
  377.                 should be thought of as a little "tweak" for those who
  378.                 want the absolute best performance.  If you use it for a
  379.                 file that contains non-blocked paragraphs, of course,
  380.                 performance will be worse.
  381.                 
  382.                 
  383.             3.  -M#
  384.             
  385.                 TEXTCON automatically determines the size of the
  386.                 document's left margin, but again, it may make a mistake
  387.                 if the margin becomes smaller toward the end of the
  388.                 document.  If this happens, the conversion will stop at
  389.                 that point with an error message.  It will tell you what
  390.                 the new, smaller margin value is, and instruct you to
  391.  
  392.  
  393.  
  394.                                           6
  395.  
  396.  
  397.  
  398.  
  399.  
  400.             TEXTCON File Converter
  401.  
  402.  
  403.                 rerun TEXTCON using the -M option with that value.  This
  404.                 is the only case where you should need to use this
  405.                 option.
  406.                 
  407.                 
  408.             4.  -F#, -H#
  409.             
  410.                 These are two of the trickier options in TEXTCON, and
  411.                 should be used with caution.  Their purpose is to remove
  412.                 running headers and footers from page-formatted files,
  413.                 so they don't wind up intermingled with the text.  They
  414.                 have the potential to save a lot of manual editing time
  415.                 on some files, but they can mistakenly remove text lines
  416.                 instead.  Of course, the original file is not modified
  417.                 in any case, so if it doesn't work correctly you can
  418.                 rerun TEXTCON without these options.
  419.                 
  420.                 The numeric parameter used with these options is the
  421.                 number of the line on each page that contains the header
  422.                 or footer.  If you don't want to figure this out
  423.                 yourself, you can omit the number or use a value of
  424.                 zero, and TEXTCON will try to determine which line(s)
  425.                 contain the header and/or footer.  Thus, -H3 -F64 would
  426.                 ask TEXTCON to remove the third and sixty-fourth lines
  427.                 of each page and attempt to join the text across page
  428.                 boundaries.  -F by itself, on the other hand, would
  429.                 imply there was no running header and that TEXTCON
  430.                 should determine which line number appears to be a
  431.                 footer.
  432.                 
  433.                 These options depend on a number of assumptions:
  434.                 o   that your document either has exactly 66 lines per
  435.                     page, or it has less than 66 lines per page and uses
  436.                     form feed characters to go to a new page (Note that
  437.                     if a file has extra lines without linefeeds for the
  438.                     purpose of underlining or boldface, these will be
  439.                     stripped, and don't count towards the 66 lines per
  440.                     page.),
  441.                 o   that the header or footer is only one line long,
  442.                 o   that the header or footer always appears on the same
  443.                     line of every page
  444.                 o   if you do not specify the line number(s), a running
  445.                     header and/or footer must occur within the first two
  446.                     pages of the file
  447.                 
  448.                 If a file meets these criteria, TEXTCON will remove the
  449.                 desired lines, usually even combining paragraphs across
  450.                 page boundaries.  If a file diverges slightly from that
  451.                 description, TEXTCON may erroneously delete text lines
  452.                 from the file.  The best advice is to examine closely
  453.                 any file that has been created using this option.
  454.             
  455.             
  456.  
  457.  
  458.  
  459.  
  460.                                           7
  461.  
  462.  
  463.  
  464.  
  465.  
  466.             TEXTCON File Converter
  467.  
  468.  
  469.             5.  -W
  470.             
  471.                 TEXTCON recognizes WordStar files automatically and
  472.                 processes them accordingly.  When doing this, TEXTCON
  473.                 assumes that the writer used WordStar "correctly",
  474.                 taking advantage of all of its formatting abilities.
  475.                 
  476.                 Unfortunately, many writers use a word processor as if
  477.                 it were simply a correctable typewriter.  This may
  478.                 include, among other bad habits, using the space bar to
  479.                 align text or to "nest" paragraphs.  TEXTCON will not
  480.                 perform very well on this type of file, because it is
  481.                 neither a straight ASCII file nor a true WordStar file.
  482.                 
  483.                 The -W option tells TEXTCON to treat the input file as a
  484.                 "semi-formatted" WordStar file, thus correcting for
  485.                 these sloppy typing habits.  If you don't know how to
  486.                 recognize a poorly done WordStar file, try the
  487.                 conversion both with and without the -W option and
  488.                 compare the results.  Most WordStar files that I have
  489.                 tried converted better with the use of this option than
  490.                 without it.
  491.                 
  492.                 (For the technically minded, the -W option tells TEXTCON
  493.                 to convert all soft spaces and soft carriage returns to
  494.                 hard spaces and hard returns in order to determine the
  495.                 intended formatting of the file.  TEXTCON then strips
  496.                 out any of the spaces and carriage returns that it
  497.                 determines are not needed.  The most common undesired
  498.                 side-effect of this is that TEXTCON will occasionally
  499.                 make a wrong paragraphing decision.)
  500.                 
  501.             
  502.             6.  -X, -Y
  503.             
  504.                 As described under "POSSIBLE PROBLEMS", below, line-
  505.                 ending hyphens are normally preserved and a space is
  506.                 inserted after them, so that you can find each one and
  507.                 make a decision as to whether it needs to be kept in the
  508.                 document.  If you already know that all hyphens are
  509.                 required hyphens or that all of them are "soft" hyphens,
  510.                 you can save some editing time by using the -X or -Y
  511.                 options.
  512.                 
  513.                 The -X option indicates that all line-ending hyphens are
  514.                 required hyphens.  TEXTCON will leave them in the text
  515.                 and will not insert a blank.  This is useful if you know
  516.                 that no "soft hyphenation" has been performed on the
  517.                 file.
  518.                 
  519.                 The -Y option indicates that all line-ending hyphens are
  520.                 "soft" hyphens, and that TEXTCON should remove them
  521.                 entirely.  This is not a very useful option, because it
  522.  
  523.  
  524.  
  525.  
  526.                                           8
  527.  
  528.  
  529.  
  530.  
  531.  
  532.             TEXTCON File Converter
  533.  
  534.  
  535.                 would be a rare document that you could safely assume
  536.                 had no line-ending required hyphens.
  537.                 
  538.             
  539.             7.  -Z#
  540.                 
  541.                 This is a very specialized option that would not often
  542.                 be used on standard document files.  It allows you to
  543.                 specify an alternative character that marks the ends of
  544.                 "paragraphs" in your file.
  545.                 
  546.                 The character is specified by means of its decimal ASCII
  547.                 code, so for example, -Z14 would look for a Ctrl-N to
  548.                 mark the ends of paragraphs, -Z35 would look for the
  549.                 symbol #, and -Z236 would look for the infinity symbol
  550.                 Ï.  The only ASCII values not allowed are 0 and 255.
  551.                 
  552.                 When this option is used, TEXTCON will do two things
  553.                 differently:
  554.                 a.  treat all carriage returns as soft returns, removing
  555.                     them from the file, and
  556.                 b.  treat all occurrences of the specified character as
  557.                     hard returns, removing them from the file and
  558.                     substituting a carriage-return/line-feed pair.
  559.                 
  560.                 This option can be extremely useful for certain types of
  561.                 file transfers, particularly those involving databases,
  562.                 certain desktop publishing applications, and
  563.                 manipulations of bulletin board message files
  564.             
  565.             
  566.             
  567.                 SPECIAL PROCESSING DESCRIPTORS
  568.             
  569.             1.  -K<sub-options>
  570.                 
  571.                 As mentioned earlier, one of TEXTCON's major jobs is to
  572.                 remove certain unneeded elements from your file.  In
  573.                 some cases you may want some of these elements to be
  574.                 kept; the -K option allows this.
  575.                 
  576.                 The -K option is a bit different from the other options
  577.                 in the way it is specified.  It has several "sub-
  578.                 options" represented by additional key letters, which
  579.                 must immediately follow the -K.  If, for example, you
  580.                 wanted only the S sub-option, the full option descriptor
  581.                 would be -KS, whereas if you wanted all of the sub-
  582.                 options, you would use -KSCRB.  (You may also use the
  583.                 full option more than once on the command line, so -KS
  584.                 -KC -KR -KB would also invoke all of the sub-options.)
  585.                 
  586.                 The "Keep" sub-options are as follows:
  587.             
  588.  
  589.  
  590.  
  591.  
  592.                                           9
  593.  
  594.  
  595.  
  596.  
  597.  
  598.             TEXTCON File Converter
  599.  
  600.  
  601.                 a.  S sub-option
  602.             
  603.                     The S sub-option of Keep instructs TEXTCON to keep
  604.                     all spaces in the converted file.
  605.                     
  606.                     In addition to the substitution of tabs for multiple
  607.                     spaces (described under the -T# option below),
  608.                     TEXTCON replaces any set of two or more spaces with
  609.                     a single space unless it is at the end of a
  610.                     sentence.  At the end of a sentence, it replaces
  611.                     three or more spaces with two.  This helps with
  612.                     files that have had spaces added to justify the
  613.                     right margin.  TEXTCON also removes all leading and
  614.                     trailing spaces from each line it processes.
  615.                 
  616.                     In some special cases this processing may be
  617.                     undesirable.  The S sub-option of Keep overrides
  618.                     both the substitution of tabs for multiple spaces
  619.                     and the deletion of spaces, so that all spaces are
  620.                     kept as found in the original file.  You would not
  621.                     normally want to use this option for a file with a
  622.                     left margin of spaces, because those spaces would be
  623.                     incorporated into the paragraphs of text.
  624.             
  625.                 b.  B sub-option
  626.             
  627.                     The B sub-option of Keep instructs TEXTCON to keep
  628.                     all blank lines (except those within double-spaced
  629.                     paragraphs) in the converted file.
  630.                 
  631.                     Normally, if TEXTCON encounters more than two
  632.                     consecutive blank lines (or four in a double-spaced
  633.                     document) it removes the "extra" ones (in either
  634.                     case, leaving only two in the converted document).
  635.                 
  636.                     It also tries to recognize print-image files, i.e.
  637.                     ones that contain the actual page breaks in the form
  638.                     of multiple blank lines or form-feed characters at
  639.                     the end of one page and beginning of the next.  If
  640.                     it does recognize this, it will remove the page
  641.                     break entirely and will reconstruct a paragraph
  642.                     broken between the pages.  When TEXTCON's analysis
  643.                     detects this type of format, it prints a message
  644.                     describing the file as "page-formatted".
  645.                 
  646.                     The B sub-option of Keep overrides this blank-line
  647.                     stripping, so that all blank lines are kept in the
  648.                     file.
  649.             
  650.                 c.  R sub-option
  651.             
  652.                     The R sub-option of Keep instructs TEXTCON to keep
  653.                     all carriage returns in the converted file.
  654.                     
  655.  
  656.  
  657.  
  658.                                          10
  659.  
  660.  
  661.  
  662.  
  663.  
  664.             TEXTCON File Converter
  665.  
  666.  
  667.                     Some word processors (including WordStar, Microsoft
  668.                     Word, SuperWriter, and WordVision) create files that
  669.                     do not have carriage returns at the ends of lines,
  670.                     but only at the ends of paragraphs.  This greatly
  671.                     simplifies the job that TEXTCON has to do.  TEXTCON
  672.                     will normally recognize these files, and display the
  673.                     message "All carriage returns will be preserved."
  674.                     If it does not recognize such a file, the usual
  675.                     symptom is that the converted file frequently has
  676.                     what should be separate paragraphs combined into one
  677.                     paragraph.  In this case you will need to use the R
  678.                     sub-option of Keep.
  679.                 
  680.                     This is needed very rarely however.  The most common
  681.                     use that I have found for this sub-option is to take
  682.                     advantage of some of TEXTCON's other features, such
  683.                     as tab insertion or double-to-single-spacing
  684.                     conversion, without its carriage-return stripping.
  685.                     
  686.                     Note that the R sub-option does not affect blank
  687.                     lines.  These are still stripped from the file
  688.                     according to the rules explained above.  If you want
  689.                     to keep all lines intact you must use both the R and
  690.                     B sub-options.
  691.                     
  692.                 d.  C sub-option
  693.                     
  694.                     The C sub-option of Keep instructs TEXTCON to keep
  695.                     all control codes (ASCII characters between 1 and
  696.                     31.
  697.                     
  698.                     TEXTCON normally strips all control codes, with the
  699.                     exception of tab characters.  If you want control
  700.                     codes kept, use the C sub-option.
  701.             
  702.             
  703.             2.  -T#
  704.             
  705.                 TEXTCON was designed primarily for importing files to
  706.                 the more sophisticated word processors, where documents
  707.                 are often printed with proportional spacing.  For this
  708.                 kind of work, tabs are used extensively to position
  709.                 items in a document; multiple spaces will not work
  710.                 correctly.  For this reason, TEXTCON preserves tabs
  711.                 rather than expanding them with blanks.  In some cases,
  712.                 multiple blanks are preferable, so I have provided an
  713.                 option for this.
  714.                 
  715.                 The -T option requires a numeric value (e.g., -T4 or
  716.                 -T0), specifying the number of spaces between tab stops.
  717.                 The first tab stop is always at column one.  When a tab
  718.                 is found, enough spaces are substituted in the converted
  719.                 file to position the following character at the next tab
  720.                 stop.  The default, of course, (if the -T option is not
  721.  
  722.  
  723.  
  724.                                          11
  725.  
  726.  
  727.  
  728.  
  729.  
  730.             TEXTCON File Converter
  731.  
  732.  
  733.                 specified at all) is that tabs are preserved, whereas a
  734.                 value of zero (-T0) means they are removed entirely.
  735.                 
  736.                 If the -T option is used, TEXTCON's normal behavior of
  737.                 substituting tabs for multiple spaces is turned off
  738.                 also.  This substitution is normally done in three
  739.                 circumstances: at the beginning of a paragraph whose
  740.                 first line is indented; between items in a columnar
  741.                 table; and between a list-identifying number, letter, or
  742.                 other symbol and the corresponding list entry (for
  743.                 example, the item "3.   -I#" just below).
  744.                 
  745.                 This means that if you have a file that does not contain
  746.                 tabs, and you simply want to suppress TEXTCON's
  747.                 substitution of tabs for spaces, you can use -T with any
  748.                 numeric value to accomplish this.  The number you use
  749.                 doesn't really matter here, since it is used only to
  750.                 determine the number of spaces to substitute when a tab
  751.                 is found in the original file.
  752.             
  753.             
  754.             3.  -I#
  755.             
  756.                 As described under the -T# option, TEXTCON normally
  757.                 substitutes a tab character for multiple spaces at the
  758.                 beginning of indented paragraphs.  The -I# option allows
  759.                 you to use a specific number of spaces instead, or to
  760.                 convert indented paragraphs to block-style paragraphs.
  761.             
  762.                 This option requires a numeric value indicating how many
  763.                 spaces are to be used for indentation.  If, for example,
  764.                 you specify -I5, all indented paragraphs in the
  765.                 converted file will have a first-line indentation of
  766.                 five spaces.  Using -I0 will convert indented paragraphs
  767.                 to block-style paragraphs (zero indentation).  The -I#
  768.                 parameter has no effect at all on paragraphs that are
  769.                 already block-style or have hanging indents.
  770.             
  771.             
  772.             4.  -P#
  773.             
  774.                 TEXTCON normally leaves paragraphs spaced the same way
  775.                 they are spaced in the original file.  The usual style
  776.                 for single-spaced documents has one blank line between
  777.                 paragraphs; double-spaced documents usually have no
  778.                 extra blank lines.  If your original document has one
  779.                 kind of line spacing and you want to print the new
  780.                 document with different spacing, you may find that the
  781.                 paragraph spacing is either too large or too small.
  782.             
  783.                 The -P# option lets you change that spacing.  For
  784.                 example, -P0 will eliminate any extra blank lines
  785.                 between paragraphs, so you might use it if your original
  786.                 file was single-spaced and you wanted to print the new
  787.  
  788.  
  789.  
  790.                                          12
  791.  
  792.  
  793.  
  794.  
  795.  
  796.             TEXTCON File Converter
  797.  
  798.  
  799.                 copy double-spaced.  -P1 will end each paragraph with
  800.                 exactly one blank line, so you might use it for the
  801.                 opposite case.
  802.             
  803.                 The -P# parameter has no effect on paragraphs that
  804.                 consist of a single line of text; those are assumed to
  805.                 be lists or tables whose spacing should be preserved.
  806.             
  807.             
  808.             5.  -L#
  809.             
  810.                 TEXTCON automatically determines a "typical" line length
  811.                 for your document and from this calculates a "cutoff"
  812.                 length used in its paragraph-determination algorithms.
  813.                 If a line is shorter than the cutoff length, TEXTCON
  814.                 assumes that the carriage return at the end of that line
  815.                 was put there intentionally, and the program will not
  816.                 delete it.
  817.                 
  818.                 You can use the -L# option to override TEXTCON and
  819.                 specify your own cutoff length.  Note that the length of
  820.                 a line is not measured from the very beginning of the
  821.                 line (column 1), nor is it measured from the first non-
  822.                 blank character on that particular line.  The length is
  823.                 measured starting at the left margin of the document,
  824.                 which is determined by the leftmost non-blank character
  825.                 found anywhere in the document.  If, for example, the
  826.                 left margin of the document were 10 characters (meaning
  827.                 the leftmost character in any line occurred in position
  828.                 11) and the cutoff length were 30, a line with 15
  829.                 leading spaces followed by 20 characters would have a
  830.                 length of 15+20-10 = 25, and so would be shorter than
  831.                 the cutoff length.
  832.                 
  833.                 
  834.             6.  -S#
  835.                 
  836.                 The -S# option is useful for word processors such as
  837.                 Volkswriter and PC-Write which require carriage returns
  838.                 at the end of each line rather than at the end of each
  839.                 paragraph.  It tells TEXTCON to split each paragraph
  840.                 into lines of a particular length, given by the numeric
  841.                 parameter.  For example, -S65 says that the output file
  842.                 should contain lines that are approximately 65
  843.                 characters long.
  844.                 
  845.                 When you use this option TEXTCON splits lines at the
  846.                 first space following the specified length.  This means
  847.                 that the lines in the file will, on average, be one word
  848.                 longer than the length you specify, and some of them may
  849.                 be as much as 10 or 15 characters longer.
  850.                 
  851.                 This option will only work on files that have very long
  852.                 lines, that is, those files where TEXTCON will keep all
  853.  
  854.  
  855.  
  856.                                          13
  857.  
  858.  
  859.  
  860.  
  861.  
  862.             TEXTCON File Converter
  863.  
  864.  
  865.                 carriage returns.  It will not, for example, allow you
  866.                 to take a file with paragraphs made up of 80 character
  867.                 lines and reformat those into paragraphs of 60 character
  868.                 lines.  That would require it to remove some carriage
  869.                 returns and add others, which it cannot currently do.
  870.                 Almost any word processor should be capable of that kind
  871.                 of reformatting.
  872.                 
  873.                 
  874.             
  875.             POSSIBLE PROBLEMS:
  876.             
  877.             
  878.             Many of TEXTCON's decisions are based on its analysis of the
  879.             beginning of your input file.  It analyzes approximately two
  880.             pages of text, but this will vary from file to file.  If
  881.             your file has sections that are very distinct in formatting,
  882.             the parameters that TEXTCON determines from the beginning of
  883.             your file may not be accurate for the rest of the file.  In
  884.             these cases, TEXTCON will perform better if you subdivide
  885.             the input file and process each distinctly formatted section
  886.             separately.
  887.             
  888.             Words from the original file that are hyphenated at the end
  889.             of a line will remain hyphenated, and an extra space will be
  890.             inserted following the hyphen.  For example, the word ex-
  891.             ample will be converted to ex- ample.  You can find these
  892.             and convert them fairly easily by searching for "- " (a
  893.             hyphen followed by a blank).  The program could have been
  894.             designed to remove hyphens at the ends of lines, but then it
  895.             would also have removed required hyphens, as in ex-
  896.             president.  You may want to use the -X or -Y options to
  897.             change this behavior.
  898.             
  899.             When a converted file is loaded into the new word processor,
  900.             tables may have their columns too close together or too far
  901.             apart.  This is because TEXTCON puts tab characters into
  902.             tables, but it cannot set the positions for the tab stops.
  903.             As soon as you set the tab stops where you want them, the
  904.             columns will line up correctly.  The TEXTDCA version of
  905.             TEXTCON can also preserve the settings of the tab stops,
  906.             thus saving some additional time.
  907.             
  908.             Sometimes TEXTCON will fail to remove the carriage returns
  909.             within a nested or fully-indented paragraph.  A common
  910.             reason for this is that the person who created it started
  911.             each line with a tab, rather than using an indent command.
  912.             You can get around this by using the -T# option with some
  913.             suitable tab value (usually 5 is a good choice).
  914.             
  915.             This problem will also occur if the paragraph is indented a
  916.             large amount from the right margin, making the lines shorter
  917.             than the cutoff length.  Correct this with the -L# option,
  918.             using a numeric value that is less than the shortest line.
  919.  
  920.  
  921.  
  922.                                          14
  923.  
  924.  
  925.  
  926.  
  927.  
  928.             TEXTCON File Converter
  929.  
  930.  
  931.             Be sure to take into account the document margin when
  932.             calculating this number.
  933.             
  934.             The program is written in C, using the DeSmet C compiler.  I
  935.             have tested it only on IBM PC-compatibles, but it should
  936.             work on other MSDOS machines.  I have heard from one person
  937.             who has used it successfully on a DEC Rainbow.
  938.             
  939.             
  940.             
  941.             OTHER USES FOR TEXTCON:
  942.             
  943.             
  944.             TEXTCON users have found some ingenious ways to use the
  945.             program - tasks for which the program was not intended, but
  946.             which it does quite well.  The following examples may
  947.             suggest some additional ways TEXTCON can aid in your text
  948.             processing work.
  949.             
  950.             1.  Use of the Keep Option
  951.             
  952.                 TEXTCON's -K option figures prominently in most of these
  953.                 special uses.  If you use -K with all of its sub-options
  954.                 (-KBCRS), the output file will be identical to the input
  955.                 file, with a few exceptions.  This would seem to be a
  956.                 pointless thing to do, unless, of course, those
  957.                 exceptions are important to you.  They are as follows:
  958.                 a.  If the input file has lines that end with only a
  959.                     carriage return, TEXTCON will add a line feed to
  960.                     each of them.  You may occasionally get files of
  961.                     this type, from certain programs or from other
  962.                     computers, and you may find that your word processor
  963.                     will not accept them without the line feeds.
  964.                 b.  If the input file has no detectable formatting,
  965.                     TEXTCON assumes it was intended for a print
  966.                     formatter.  In this case, TEXTCON will remove "dot"
  967.                     commands from the file.
  968.                 c.  TEXTCON deletes trailing blanks from each line.
  969.                 d.  WordStar files are always converted to ASCII.
  970.             
  971.                 Each of these conversions can be extremely useful for
  972.                 certain kinds of files, even when you don't need the
  973.                 carriage-return stripping that is TEXTCON's main
  974.                 purpose.
  975.                 
  976.                 
  977.             2.  Adding Carriage Returns
  978.             
  979.                 You may sometimes get files from another computer where
  980.                 a line-feed character, rather than a carriage return, is
  981.                 used to mark the ends of lines.  This causes great
  982.                 difficulty for some PCDOS software.
  983.                 
  984.  
  985.  
  986.  
  987.  
  988.                                          15
  989.  
  990.  
  991.  
  992.  
  993.  
  994.             TEXTCON File Converter
  995.  
  996.  
  997.                 TEXTCON can convert these files by use of the -Z#
  998.                 option.  The decimal ASCII code for line feed is 10, so
  999.                 the full option would be -Z10.  You may also want to use
  1000.                 -KBCS to keep other characteristics of the file intact.
  1001.                 The -Z# option overrides the -KR option.
  1002.                 
  1003.                 
  1004.             3.  Removing Blank Lines
  1005.                 
  1006.                 TEXTCON removes multiple blank lines by default, but
  1007.                 leaves up to two blank lines separating paragraphs.  If
  1008.                 you want to remove all blank lines from a file, use the
  1009.                 -P0 option.  One TEXTCON user needed a count of only the
  1010.                 non-blank lines in an ASCII file, but couldn't find a
  1011.                 counting program that would do that.  Using TEXTCON with
  1012.                 -P0 and -KR produced a file with only the blank lines
  1013.                 removed.
  1014.                 
  1015.                 
  1016.             4.  Tab Expansion
  1017.                 
  1018.                 For certain programs and certain applications it may be
  1019.                 inconvenient to have tabs in a file.  TEXTCON can remove
  1020.                 them and expand them to spaces via the -T# option.  If
  1021.                 you use this along with the -KBCRS option, the output
  1022.                 file will be nearly identical to the input file, but
  1023.                 with tabs exapnded to spaces.
  1024.                 
  1025.                 This option can also be useful when dealing with badly
  1026.                 formatted files.  Some people create fully indented
  1027.                 paragraphs by inserting a tab at the beginning of every
  1028.                 line of the paragraph rather than by using their word
  1029.                 processor's indent function.  This creates a mess if you
  1030.                 have to edit those paragraphs or move them to another
  1031.                 word processor.  TEXTCON will interpret them as
  1032.                 individual lines, not as paragraphs.  However, if you
  1033.                 use the -T# option, TEXTCON will correctly recognize
  1034.                 them as fully indented paragraphs.
  1035.             
  1036.                                           
  1037.                                           
  1038.             GUIDELINES FOR SPECIFIC WORD PROCESSORS:
  1039.                                           
  1040.                                           
  1041.             The following gives some guidelines for preparing documents
  1042.             for an ASCII file transfer with five different word proces-
  1043.             sors.  It is written with the assumption that you will be
  1044.             transferring the files to the NBI Oasys 64 system.  However,
  1045.             almost all of the advice also applies to transfers into
  1046.             WordStar, Word Perfect, and Microsoft Word.
  1047.             
  1048.             There are certain restrictions imposed by the ASCII transfer
  1049.             process that apply to all word processors:
  1050.             
  1051.  
  1052.  
  1053.  
  1054.                                          16
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.             TEXTCON File Converter
  1061.  
  1062.  
  1063.             1)  All character formatting, such as boldface, underline,
  1064.                 subscripting, and superscripting, is lost.  The text
  1065.                 that it applies to remains intact, but the formatting
  1066.                 must be redone on the target word processor.
  1067.             
  1068.             2)  All spacing characteristics, such as margins, inden-
  1069.                 tation, centering, and justification are lost.  All
  1070.                 paragraphs, including nested ones, will be moved to
  1071.                 start at the left margin.  Paragraphs with a first-line
  1072.                 indent (i.e., non-block style) will have a tab inserted
  1073.                 for this purpose.
  1074.             
  1075.             
  1076.             Microsoft Word
  1077.             
  1078.             Microsoft Word is probably more compatible with the NBI sys-
  1079.             tem than is any other word processor.  There are only two
  1080.             rules to remember when using Word.  Use tabs rather than
  1081.             multiple spaces in your original document for maximum
  1082.             flexibility in reformatting.  Don't use the "newline" key
  1083.             (Shift-Enter), because it does not appear in an ASCII file
  1084.             as a line-ending character.
  1085.             
  1086.             Characteristics that you assign to your document using the
  1087.             Format command (Character, Paragraph, or Division) will be
  1088.             lost in the transfer.  Footnotes entered using Format
  1089.             Footnote will be transferred, but they will all be grouped
  1090.             together at the end of the file and there will be no indi-
  1091.             cation of where they are referenced.
  1092.             
  1093.             To save your file in ASCII form, you must use the Transfer
  1094.             Save command with the "Formatted" option set to "No".  Be
  1095.             sure to give the file a different name than you have been
  1096.             using for your document, or the ASCII file will replace your
  1097.             formatted document file. (If you make this mistake, you
  1098.             should immediately exit Word and copy the .BAK file back to
  1099.             the .DOC file and then try the save again.)
  1100.             
  1101.             
  1102.             Word Perfect
  1103.             
  1104.             Use tabs rather than multiple spaces in your original
  1105.             document for maximum flexibility in reformatting.
  1106.             
  1107.             Footnotes and endnotes will not be included in the ASCII
  1108.             file; they will have to be retyped on the NBI.
  1109.             
  1110.             You should use the Text In/Out command (Extended Features -
  1111.             Prepare/Protect in version 3) to save your file in ASCII
  1112.             form.  Do not use the Print command to create this file.
  1113.             When you use the Text In/Out command, do not use the same
  1114.             file name that you use for your document, or the ASCII file
  1115.             will replace your formatted document file and there will be
  1116.             no way to get it back.
  1117.  
  1118.  
  1119.  
  1120.                                          17
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.             TEXTCON File Converter
  1127.  
  1128.  
  1129.             
  1130.             Version 4.2 of Word Perfect has a new, additional method of
  1131.             file saving available under the Text In/Out command.  This
  1132.             creates an ASCII file with only the paragraph-ending
  1133.             carriage returns included.  If you create an ASCII file
  1134.             using this option, there is no need to use TEXTCON before
  1135.             importing the file to another word processor, unless you
  1136.             want to do some special reformatting such as expanding tabs,
  1137.             changing paragraph spacing, etc.
  1138.             
  1139.             
  1140.             PC-Write and Volkswriter
  1141.             
  1142.             Files from these two word processors can be the most diffi-
  1143.             cult ones to transfer, because their format is so dependent
  1144.             on the style of the particular writer.  Fortunately,
  1145.             TEXTCON's paragraph-recognition algorithms really shine when
  1146.             working with files from these word processors, so there are
  1147.             relatively few rules for you to follow.
  1148.             
  1149.             Turn the Justify option off, so your text is not right-
  1150.             justified.  TEXTCON will take out extra blanks that are
  1151.             inserted for justification, but it occasionally makes
  1152.             mistakes.
  1153.             
  1154.             PC-Write and Volkswriter convert all tabs to spaces, which
  1155.             means that tables may not transfer well.  TEXTCON tries to
  1156.             put tabs back in where they are needed, but will not always
  1157.             do this correctly.
  1158.             
  1159.             Footnotes will be transferred to the NBI, but they will
  1160.             appear in the middle of the text that references them.
  1161.             
  1162.             PC-Write and Volkswriter files are always stored in ASCII
  1163.             form, so you don't have to do any special type of save
  1164.             before transferring the file.
  1165.             
  1166.             
  1167.             WordStar
  1168.             
  1169.             WordStar files can be converted very effectively by TEXTCON.
  1170.             The only limitation is that tables may not transfer very
  1171.             well, because WordStar converts all tabs to spaces.  TEXTCON
  1172.             tries to put tabs back in where needed, but will not always
  1173.             do this correctly.
  1174.             
  1175.             WordStar files can be read directly by TEXTCON; you do not
  1176.             have to do a print to disk.  Be sure to try the -W option
  1177.             when using TEXTCON on WordStar files.  It is not required,
  1178.             but it generally gives a better translation.
  1179.             
  1180.             
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                                          18
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.             TEXTCON File Converter
  1193.  
  1194.  
  1195.             HISTORY:
  1196.             
  1197.             
  1198.             The original version of this program was written to assist
  1199.             in the transfer of documents from microcomputer word proces-
  1200.             sors and optical scanners to an NBI Oasys office system.
  1201.             Because of the wide variety of word processors used by the
  1202.             people involved, it wasn't practical to try to accommodate
  1203.             all the different internal file formats.  Instead, the
  1204.             program was designed to reformat standard ASCII files into a
  1205.             form that could be imported easily into another word
  1206.             processor.  It was very important that the program properly
  1207.             process as many different varieties of ASCII file formats
  1208.             and writing styles (indentations, paragraphing, line
  1209.             spacing, etc.) as possible.
  1210.             
  1211.             The original program was quite complicated to use and the
  1212.             algorithm employed was quite simple-minded, so that certain
  1213.             formats were not handled as well as they could be.  This new
  1214.             program is based on two years' experience examining files
  1215.             from different writers with different word processors,
  1216.             talking to secretaries about how they set up different
  1217.             documents, and identifying the significant patterns of lines
  1218.             and characters that commonly occur.  The program now
  1219.             analyzes each input file and makes very intelligent
  1220.             decisions about the type of file and the paragraphing style
  1221.             used.
  1222.             
  1223.                 Version 1.1
  1224.                 
  1225.                 This was the first version to be widely distributed.
  1226.                 
  1227.                 
  1228.                 Version 1.2
  1229.                 
  1230.                 1.  Renamed the former -L option to -B.
  1231.                 2.  Changed the -T# option to use true tab stops.
  1232.                 2.  Added new -L# option, as well as -H, -Y, and -R.
  1233.                 3.  Expanded the file analysis stage to determine
  1234.                     additional document characteristics, including
  1235.                     typical line length, standard margin, recognition of
  1236.                     unformatted, formatted, and print-formatted files,
  1237.                     and header and footer locations.
  1238.                 4.  Fixed a bug in the table-recognition section.
  1239.                 5.  Additional fine-tuning of parameters and algorithms,
  1240.                     particularly in regard to hanging indents, centered
  1241.                     lines, and list items.
  1242.                 
  1243.                 
  1244.                 Version 1.3
  1245.                 
  1246.                 (NOTE:  If you used an earlier version and have not sent
  1247.                 a contribution, please consider doing so now.)
  1248.                 
  1249.  
  1250.  
  1251.  
  1252.                                          19
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.             TEXTCON File Converter
  1259.  
  1260.  
  1261.                 1.  Renamed many options.  -B, -C, and -S became the B,
  1262.                     R, and S sub-options of the new -K (for Keep)
  1263.                     option.  -R was split into the -F and -H options,
  1264.                     both of which now accept a line number as a
  1265.                     parameter.  -D became -2, and -H became -X.  I hated
  1266.                     to change these so substantially, but it really
  1267.                     seemed necessary.  I don't think a major change will
  1268.                     be necessary again.
  1269.                 2.  Dropped one option.  -W was no longer needed because
  1270.                     of improvement in recognition of WordStar files.
  1271.                     However, see the new -W option below.
  1272.                 3.  Added new options.  -1 option specifies single
  1273.                     spacing.  -B specifies that all paragraphs are block
  1274.                     style.  -M# specifies the minimum size of the left
  1275.                     margin of the document.  -W option specifies
  1276.                     different processing of WordStar files.  -Z#
  1277.                     specifies that the original file has a particular
  1278.                     character that always marks paragraph ends.  -S#
  1279.                     will split files with long lines into shorter lines.
  1280.                     The C sub-option of the -K option specifies that
  1281.                     control codes are to be kept in the new file.
  1282.                 4.  Automatic removal of lines that are added only for
  1283.                     print emphasis.  In a file whose lines end in CR-LF
  1284.                     pairs, these are easily recognized because they are
  1285.                     preceded by a line without a line feed.
  1286.                 5.  Additional improvement of decision rules and general
  1287.                     fine tuning for better paragraph recognition.
  1288.                 
  1289.                 
  1290.                 TEXTDCA Version 1.3
  1291.                 
  1292.                 Introducing a new program which will be sent to those
  1293.                 contributing $25 or more for TEXTCON.  It has two
  1294.                 features not found in TEXTCON:
  1295.                 1.  DCA/RFT output format.  The -D option specifies that
  1296.                     instead of an ASCII file, the output should be
  1297.                     written in DCA/RFT format.  Most of the major PC
  1298.                     word processors now support this format, which
  1299.                     unlike ASCII files, can contain formatting
  1300.                     information such as margins, centering, tab
  1301.                     settings, indents, etc.  Now TEXTCON can pass all
  1302.                     this information on to your word processor, saving a
  1303.                     tremendous amount of reformatting.
  1304.                 2.  Menu mode.  TEXTDCA permits optional menu-driven
  1305.                     selection of processing options, for those who have
  1306.                     trouble with its normal command-line syntax.  The
  1307.                     menu system works only on IBM-PC-compatibles, not on
  1308.                     MSDOS machines such as the Wang PC, DEC Rainbow, TI
  1309.                     Professional, Tandy 2000, etc.
  1310.             
  1311.             
  1312.             
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.                                          20
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.             TEXTCON File Converter
  1325.  
  1326.  
  1327.             DISTRIBUTION:
  1328.             
  1329.             
  1330.             The TEXTCON program described above is Copyright, 1986,
  1331.             Chris Wolf.
  1332.             
  1333.             TEXTCON accomplishes its purpose as described above and, if
  1334.             used carefully, will cause no known damage to a computer
  1335.             system or its files.  All users should maintain backup
  1336.             copies of their own files and the author bears no responsi-
  1337.             bility for losses arising from their failure to do so.
  1338.             
  1339.             TEXTCON may be freely copied and distributed to others, but
  1340.             no one may charge a fee for such distribution, beyond a
  1341.             modest disk preparation charge.  All copies of TEXTCON must
  1342.             be accompanied by this documentation file.
  1343.             
  1344.             I intend to support this program, continue to enhance it,
  1345.             and fix bugs in it.  If you encounter problems with it, or
  1346.             have questions about it, I would like to hear from you.  My
  1347.             Compuserve ID is 72446,2704.
  1348.             
  1349.             If you find that this program saves you time in your work
  1350.             and you use it regularly, please send me a contribution to
  1351.             help offset the time and resources I have spent developing
  1352.             and supporting it.  If you are using it in an office
  1353.             environment, with multiple users on multiple computers,
  1354.             please consider this in determining the size of your
  1355.             contribution.
  1356.             
  1357.             Those who contribute $25 or more will be sent the TEXTDCA
  1358.             program, which is described elsewhere in this documentation.
  1359.             
  1360.             Chris Wolf
  1361.             1521 Greenview Ave.
  1362.             East Lansing, MI  48823
  1363.             office phone - (517) 353-5017
  1364.             
  1365.             
  1366.             
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.                                          21
  1385.  
  1386.  
  1387.